Skip to content

feat: DAG-aligned improvements (v2.6.0)#17

Merged
ducdmdev merged 22 commits intomainfrom
feat/dag-aligned-improvements
Mar 20, 2026
Merged

feat: DAG-aligned improvements (v2.6.0)#17
ducdmdev merged 22 commits intomainfrom
feat/dag-aligned-improvements

Conversation

@ducdmdev
Copy link
Owner

Summary

Adds three DAG-aligned features to the agent-team-plugin, all powered by a centralized task-graph.json workspace file:

  • Critical Path Identificationcompute-critical-path.sh hook recomputes the longest dependency chain after every task completion. Leads prioritize critical-path blockers over non-critical work. Includes cycle detection and tie-breaking.
  • Task-Level Resume/Cachingdetect-resume.sh hook detects incomplete workspaces at session start with smart staleness validation (epoch-second git timestamp comparison). Users choose resume or start fresh.
  • Early Integration Checkpointscheck-integration-point.sh hook detects when convergence points (diamond dependencies) become fully unblocked and nudges the lead to verify interface compatibility.

New files (6)

  • scripts/compute-critical-path.sh — TaskCompleted hook (critical path)
  • scripts/detect-resume.sh — SessionStart hook (resume detection)
  • scripts/check-integration-point.sh — TaskCompleted hook (integration checkpoints)
  • tests/hooks/test-compute-critical-path.sh — 13 assertions
  • tests/hooks/test-detect-resume.sh — 10 assertions
  • tests/hooks/test-check-integration-point.sh — 11 assertions

Modified files (19)

  • hooks/hooks.json — 3 new hook entries (9 total)
  • docs/shared-phases.md — Phase 1b convergence points, Phase 2 critical path display, Phase 3 resume detection + task-graph.json creation, Phase 4 Critical Path Awareness
  • docs/workspace-templates.md — task-graph.json schema, CP column in tasks.md template
  • docs/coordination-patterns.md — Resume from Existing Workspace + Integration Checkpoint Response patterns, synced Lead Processing table
  • docs/coordination-advanced.md — Deadline Escalation critical-path acceleration
  • docs/report-format.md — Critical path metrics, CP column in Task Ledger
  • All 5 skills/*/SKILL.md — step 4a reference, agent-implement convergence gate
  • README.md — workspace tree, 3 hook descriptions, plugin structure
  • CLAUDE.md — hook/script counts, verification scenarios, test counts
  • CHANGELOG.md — v2.6.0 entry
  • .claude-plugin/plugin.json + marketplace.json — version 2.6.0
  • tests/lib/test-helpers.sh — task-graph mock + stdout capture helpers
  • tests/structure/test-doc-references.sh — DAG reference assertions

Test plan

  • Full test suite: 12 files, 145 assertions — all pass
  • Integration test: 13 end-to-end scenarios (lifecycle, staleness, missing files, cycles, dangling deps, malformed JSON, -fix suffix)
  • Code review: 2 rounds — all CRITICAL/HIGH/MEDIUM issues fixed
  • Documentation audit: 9 findings found, 8 fixed (1 cosmetic skipped)
  • Plugin validation: claude plugin validate . passes
  • Version sync: 2.6.0 in plugin.json, marketplace.json, CHANGELOG

ducdmdev added 22 commits March 20, 2026 09:37
Three features: Critical Path Identification, Task-Level Resume/Caching,
and Early Integration Checkpoints — all sharing a centralized
task-graph.json workspace file as their DAG engine.
15 tasks across 3 chunks: scripts+tests, documentation, release.
Covers compute-critical-path.sh, detect-resume.sh, check-integration-point.sh,
task-graph.json schema, and updates to all 19 modified files.
String comparison of ISO 8601 timestamps fails across timezones
(git log returns local TZ, completed_at may be UTC). Convert both
to epoch seconds via date command for correct comparison.
- detect-resume.sh: add "missing" file classification for deleted outputs
- detect-resume.sh: use printf %b to prevent format-specifier injection
- README.md: update hook count from "Five" to "Eight"
compute-critical-path.sh:
- CRITICAL: add cycle detection pass before DFS (prevents infinite recursion)
- HIGH: add null guard for non-existent dependency references
- HIGH: skip NEXT_CRITICAL in blocked-task loop (prevents duplicate warnings)
- LOW: fix "all parallel" message when all tasks complete

shared-phases.md:
- Add 3 new hooks to Hooks inventory section
- README.md: fix hook count "Eight" → "Nine"
- CLAUDE.md: fix test count "9 files (78 assertions)" → "12 files (145 assertions)"
- CLAUDE.md: fix "Adding a New Hook" to reference shared-phases.md (not SKILL.md)
- coordination-patterns.md: sync Lead Processing table with shared-phases.md
  (add task-graph.json update to COMPLETED, add PROGRESS/CHECKPOINT/integration rows)
- report-format.md: fix stale "Phase 5, step 7" reference
- shared-phases.md: fix "critical chain" → "critical path" terminology (2 occurrences)
@ducdmdev ducdmdev merged commit ac19db2 into main Mar 20, 2026
1 check passed
@ducdmdev ducdmdev deleted the feat/dag-aligned-improvements branch March 20, 2026 03:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant